Skip to content

docs: v25 migration guide for upcoming breaking change release#9060

Merged
mikehardy merged 3 commits into
mainfrom
v25-migration
Jun 22, 2026
Merged

docs: v25 migration guide for upcoming breaking change release#9060
mikehardy merged 3 commits into
mainfrom
v25-migration

Conversation

@mikehardy

@mikehardy mikehardy commented Jun 21, 2026

Copy link
Copy Markdown
Collaborator

Summary

Adds the migration guide for the upcoming v25 breaking-change release: comprehensive docs/migrating-to-v25.mdx covering TypeScript alignment and modular API changes since v24.0.0, plus a Cloud Functions New Architecture note in docs/migrating-to-v24.mdx. Also extends spellcheck to MDX and fixes related doc spelling drift.

Related TypeScript breaking-change PRs:

Test plan

  • yarn lint:markdown
  • yarn lint:spellcheck
  • Manual review of migration guide content and cross-links

@gemini-code-assist

Copy link
Copy Markdown
Contributor

Summary of Changes

Hello, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request introduces the migration guide for the upcoming v25 release, focusing on TypeScript alignment and modular API transitions. It also enhances documentation quality by updating existing guides and improving the automated spellcheck configuration to include MDX files, ensuring better consistency across the documentation suite.

Highlights

  • Migration Guide: Added a comprehensive migration guide in docs/migrating-to-v25.mdx covering TypeScript alignment and modular API changes.
  • Documentation Improvements: Updated docs/migrating-to-v24.mdx with Cloud Functions migration details and standardized terminology in the Phone Number Verification guide.
  • Tooling Enhancements: Extended the spellcheck utility to include MDX files and updated the dictionary with new technical terms.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize the Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counterproductive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for GitHub and other Google products, sign up here.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

@mikehardy mikehardy requested a review from just1and0 June 21, 2026 23:24

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request updates the documentation for migrating to v24 and v25, improves readability in the Phone Number Verification and Server Integration docs by expanding abbreviations, and updates the spellcheck script in package.json to include .mdx files. Feedback on the changes highlights a typo in the Xcode version requirement (stating Xcode 26.2+ instead of 16.2+) in the migration guide, and questions the addition of a term with a trailing period (firebase-js-sdk.) to the spellcheck dictionary as a workaround for tokenization issues.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

Comment thread docs/migrating-to-v25.mdx
Comment thread docs/migrating-to-v25.mdx
Comment thread .spellcheck.dict.txt
@mikehardy mikehardy requested a review from dackers86 June 21, 2026 23:24
@codecov

codecov Bot commented Jun 21, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 60.87%. Comparing base (74ddc9e) to head (b16a37b).

Additional details and impacted files
@@             Coverage Diff              @@
##               main    #9060      +/-   ##
============================================
+ Coverage     60.86%   60.87%   +0.01%     
  Complexity     1602     1602              
============================================
  Files           455      455              
  Lines         33589    33589              
  Branches       5438     5438              
============================================
+ Hits          20441    20443       +2     
+ Misses        12016    12015       -1     
+ Partials       1132     1131       -1     
Flag Coverage Δ
android-native 48.55% <ø> (ø)
e2e-ts-android 48.55% <ø> (ø)
e2e-ts-ios 51.56% <ø> (+0.02%) ⬆️
e2e-ts-macos 25.65% <ø> (ø)
ios-native 51.56% <ø> (?)
jest 62.25% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@mikehardy mikehardy merged commit f5497dc into main Jun 22, 2026
24 checks passed
@mikehardy mikehardy deleted the v25-migration branch June 22, 2026 17:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants